home *** CD-ROM | disk | FTP | other *** search
/ InfoMagic Internet Tools 1993 July / Internet Tools.iso / RockRidge / info-service / gopher / Unix / GopherTools / jughead / jughead.0.9 / About.jughead next >
Encoding:
Text File  |  1993-05-22  |  2.9 KB  |  64 lines
  1. jughead is an acronym for:
  2.    Jonzy's Universal Gopher Hierarchy Excavation And Display
  3. jughead head can act as a search engine on a prebuilt table
  4. that allows searching through menus, or can create a linear
  5. view of menu space.  When running jughead you can specify
  6. what part of gopherspace you want search tables built or a
  7. linear view thereof.
  8.  
  9. When running as a search engine, jughead listens out a port
  10. for a connection and a search string. The search string can
  11. contain the boolean operations "AND", "OR", and "NOT" between
  12. words.  If no operator is specified between words, it is an
  13. implied "AND" operation.  For example either:
  14.    "University of utah" or "University AND of AND Utah" will
  15. yield all gopher entries with "university" and "of" and "utah"
  16. in the title.  The case of the letters is irrelevant.  Now
  17. suppose you enter the string "university of utah NOT gopher".
  18. This will return the same information as the first search
  19. except for those entries containing the word "gopher".
  20. Currently there is no way to search on the words "AND", "OR",
  21. or "NOT"; nor is there a way to break an expression into a
  22. group of smaller expressions.  jughead also supports partial
  23. word searches, where the asterik '*' is the wildcard character.
  24. The wildcard character cannot be the first or only character
  25. in a search word, and all characters following the wildcard
  26. are ignored.  For example: both "*", and "*opher" are not
  27. valid, while "go*r" will return all items that have a word
  28. beginning with "go" in the title.  Note that the 'r' following
  29. the asterik is ignored in the search.  The maximum number of
  30. entries returned is 1024 unless you use a special command
  31. described at the end of this document.
  32.  
  33. All words are broken into smaller words if any word contains
  34. a whitespace character or one of the following characters:
  35.    !"#$%&'()+,-./:;<=>?@[\]^_`{|}~
  36. Thus if a menu item has the name "A sample.file", this is
  37. broken into the three words "A", "sample", and "file.  So if
  38. your search statement is: "sample.file some_thing-else", your
  39. query gets broken into the statment:
  40. "sample AND file AND some AND thing AND else", which will only
  41. return those items with all these words in the menu.
  42.  
  43. jughead supports some special commands, where each special
  44. command must be preceeded by a question mark '?', and are
  45. listed below:
  46.     ?all what
  47.     ?help [what]
  48.     ?limit=n what
  49.     ?version [what]
  50. where 'what' is a standard search string, anything enclosed
  51. in square brackets is optional, and all special commands must
  52. be preceeded with '?'.  And each command is described below:
  53.     ?all what    returns all the hits on 'what'.
  54.             Otherwise items will only be returned
  55.             it there are fewer than 1024 items.
  56.     ?help [what]    Gives you this document and any
  57.             optional hits on 'what'.
  58.     ?limit=n what    Returns the first 'n' items on 'what'.
  59.     ?version [what]    Returns the version of jughead and
  60.             any optional hits on 'what'.
  61. Only 1 special command is supported per query, and if any
  62. syntax error is reported as the title to this document.
  63.  
  64.